The Save Execution State Task

One of the available schedule tasks is the ability to save an execution state. This allows you to save the data that was on the dashboard at the time the report was run. The saved data includes the values of form variables and any OLAP cube data. It does not include the results of the report query, which will run live each time you run the report. Each saved execution states is stored in a file on the server where MAPS is installed, so that it can be loaded at a future date.

When you select the “Save execution state” task, the dialog box in the figure below appears. You can enter the maximum number of execution states to save for the report involved. You can also create a title for the execution state. As you can see, the default title is today’s data and time (using the Argos “Now” function) and is saved as an Argos variable.

The Edit Save State Tasks dialog box containing options for creating a Saved State.

Clicking the ellipsis at the right of the Title field launches the Expression Builder where you can create an expression to be used as the title.

Note: Any variables used in the title must be surrounded by %% characters. If you use the expression builder to construct the title, the %% will be added automatically.

Running Saved Execution States

After the execution state is saved, when running the report a list of saved execution states will listed as shown in the figure below. Running saved execution states is described fully in the Argos Report Viewer Guide.

The select a saved state dialog box that is presented when executing a saved report.

Managing Saved Execution States

Saved execution states can be managed (saved to any location on the network, or deleted) by the Report Writer or DataBlock Designer. This is done by editing the report and selecting the Saved Execution States tab as shown below. To edit a report, highlight the report in the Explorer tree then select Edit Report within the design area. Note the options to save the execution state to any desired location or to delete it.

The Edit Report dialog box that is used to manage Saved States. The Saved State tab is selected and lists the saved states for the report.

Checking the Allow running in live mode box allows the report to be run using the current state of the database.

 

Return to Editing Schedules - Tasks